HOW TO INSTALL VANI ON A MAC
============================

Vani turns your voice into a clean, ready-to-send message. Hold the fn key, speak
English, Hindi, Bengali, Telugu, Marathi, Tamil, Gujarati, Kannada, Malayalam,
Punjabi, Odia or a mix, and let go: the message is typed wherever your cursor is
(WhatsApp, Gmail, Slack, Notes, any app).

Works on macOS 13 (Ventura) or newer, on Apple Silicon and Intel Macs.
Takes about 3 minutes, once.


1. PUT VANI IN APPLICATIONS
   Open this "Vani" folder (in Downloads). Drag "Vani" onto "Applications" in the
   Finder sidebar.

2. OPEN IT THE FIRST TIME
   Vani is not from the App Store yet, so macOS asks once:
   - In Applications, right-click (or Control-click) Vani > Open > Open.
   - On macOS 15 (Sequoia) or newer, if you see "Vani Not Opened", click Done. Then go to
     System Settings > Privacy & Security, scroll to the bottom, click "Open Anyway"
     next to "Vani was blocked", type your Mac password, and click Open.
   After this, Vani opens normally, like any app.

3. ENTER YOUR INVITE CODE
   Vani asks for it on first open (it looks like VANI-XXXX-XXXX). You can also enter
   it later: click the Vani icon in the menu bar (top right) > Enter invite code.

4. ALLOW THE MICROPHONE
   Click "Allow" when macOS asks. Vani listens only while you hold fn.

5. TURN ON ACCESSIBILITY (so Vani can type into other apps, and spell the names on screen)
   System Settings > Privacy & Security > Accessibility > turn Vani ON.
   If Vani is not in the list, click +, pick Applications > Vani, click Open, then
   turn it on. (The Vani window has a "Turn on" button that opens this page.)

6. IF HOLDING fn DOES NOTHING
   - System Settings > Privacy & Security > Input Monitoring > turn Vani ON.
   - System Settings > Keyboard > "Press globe key to" > Do Nothing.
     (Otherwise fn opens the emoji picker instead.)
   Then quit Vani from the menu-bar icon and open it again.


HOW TO USE IT
-------------
- Click into any text box, HOLD fn, talk, let go. The message appears in a second or two.
- Long message? Double-tap fn: Vani keeps listening hands-free. Press fn once to finish.
  Messages of several minutes are fine.
- A quick tap on fn cancels.
- Names come out spelled the way the chat you're in spells them: say "Reddy" or "KC"
  and Vani uses the names it sees in that window.
- The menu-bar icon (a small wave) has everything else:
  English / your language's script / Roman letters (e.g. Tenglish), Language,
  Tone (chill or formal), Personal dictionary (names and places to spell right),
  Recent messages (click to copy), and Retry last recording.

SAAR (सार) — MEETING NOTES
--------------------------
For Google Meet, Zoom, Teams or any call on this Mac:
- Menu-bar icon > Start Saar — meeting notes. The first time, macOS asks to let Vani
  hear the sound your Mac plays: click Allow (that is how Saar hears the other people).
- A small pill at the top shows the clock and two meters, You and Them. Talk as usual.
- Stop when the meeting ends. A few seconds later you get the notes: the gist,
  decisions, to-dos (who, what, by when), a follow-up email (Gmail or Mail) and a
  WhatsApp recap. Nothing is sent until you click send.
- Saar hears everything your Mac plays while it is on, so pause music and videos.
  Tell people you are taking notes.
- All your notes: menu-bar icon > Saar notes.

If something goes wrong, the small black pill at the bottom of the screen says what.
If it says "Retry is in the menu", click the menu-bar icon > Retry last recording:
nothing you said is lost.


PRIVACY
-------
Your voice is turned into text and never stored. When you start talking, Vani reads the
names in the window you are typing into (the chat's title, the people in it) and sends
only those names with that one message, so it spells them right: never your messages,
and the names are not kept. Saar recordings are sent to Vani's
server and Google's Gemini to write the notes and are not kept there; the notes stay on
this Mac (menu-bar icon > Saar notes, Delete). Your messages stay on this Mac
(Vani window > History > Clear history, or menu-bar icon > Recent messages > Clear history).


TO REMOVE VANI
--------------
Menu-bar icon > Quit Vani, then drag Vani from Applications to the Trash.
